home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / SOUND / AC20MUSC.ARJ / ACCUMUSC.DOC next >
Text File  |  1991-01-12  |  47KB  |  1,094 lines

  1.                               ACCU
  2.  
  3.                           Music Printer
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                         by Kevin Fischer
  10.                            Version 2.0
  11.                Copyright (c) 1991 - Kevin Fischer
  12.                         January 12, 1991
  13. INTRODUCTION
  14.  
  15.      Are you an aspiring musician?  If so, maybe ACCU Music
  16. Printer is the program for you.  It is specifically designed for
  17. those music writers who can't write.  What that means is that you
  18. type in the music and ACCU Music Printer will print out the sheet
  19. music.  Entering the music is very easy and can be done with any
  20. text editor or word processor.  Then you run ACCU Music Printer. 
  21. It will automatically take your music and print it out to your
  22. printer quickly and easily.
  23.  
  24. SYSTEM REQUIRED
  25.  
  26.      The following equipment is necessary for running ACCU Music
  27. Printer:
  28.      o    IBM or compatible computer
  29.      o    Disk drive or hard drive
  30.      o    Printer which supports graphics
  31.       
  32.      A text editor or word processor is also recommended for
  33. using ACCU Music Printer.
  34.  
  35. NEW IN THIS VERSION
  36.  
  37.      o    Redesigned screens for MUSIC.EXE
  38.      o    Transposing utility program TRANPOSE.EXE included
  39.      o    Redesigned MUSCNFIG.EXE
  40.      o    Added ability to change key signatures, time signatures
  41.      o    Added ability to define key, time, clef, tempo, title,
  42.           author in music file
  43.      o    Added ability to add comments to music file
  44.      o    Added Alto, Tenor, and Soprano clefs
  45.      o    Redesigned the notes, clefs, etc.
  46.      o    Makes use of higher resolution printer graphics modes
  47.      o    Added Draft, Medium, and High quality modes of printing
  48.      o    Added menu to MUSIC.EXE
  49.      o    Added margin changes to MUSIC.EXE
  50.  
  51. RUNNING THE PROGRAMS
  52.  
  53.      All of the programs that come with ACCU Music Printer
  54. (MUSIC.EXE, MUSCNFIG.EXE, and TRANPOSE.EXE) have two command-line
  55. options.  All of the programs use direct screen writes.
  56.  
  57.      Options:       /BIOS     Force BIOS screen writes instead of
  58.                               direct screen writes
  59.  
  60.                     /COLOR    Attempt to force color screen mode
  61.                               if color does not appear on color
  62.                               monitor
  63.  
  64.      The format for calling any of the programs with command-line
  65. options is as follows:
  66.  
  67.      PROGNAME /BIOS /COLOR
  68.  
  69.      Both command-line options are optional and must be separated
  70. by a space.  The order does not matter.  Some examples might be:
  71.  
  72.      MUSIC /BIOS
  73.      MUSIC /COLOR /BIOS
  74.      TRANPOSE /BIOS
  75.      MUSCNFIG /COLOR
  76.  
  77. SETTING UP THE PROGRAM
  78.  
  79.      First of all, you need to copy all of the files that come
  80. with ACCU Music Printer onto a floppy disk or a directory of your
  81. hard disk.  After you have it set up on a disk or in a directory,
  82. you are ready to set it up for your printer.  Printer drivers for
  83. the program have an extension of '.PRT'.  At this point in time,
  84. only six printer drivers come with the program:
  85.  
  86. PAN1091I.PRT   Designed for the Panasonic 1091i printer.  Should
  87.                work with the Panasonic 1080, 1091, and 1092
  88.                printers also.
  89.  
  90. EPSNRX80.PRT   Designed for the Epson RX-80 printer.
  91.  
  92.  
  93. GEMINI10.PRT   Designed for the Gemini 10 printer.  Should work
  94.                with the Gemini 15 printer also.
  95.  
  96. EPSONLQ.PRT    Designed for any Epson LQ printer.  Tested on
  97.                Epson LQ 2500 compatible GSX-140.
  98.  
  99.  
  100. GSX140.PRT     Designed for the Citizen GSX-140 printer.
  101.  
  102. HPLASER.PRT    Designed for any Hewlett-Packard Laser Printer. 
  103.                Tested with the HP IID printer.
  104.  
  105.      Since there are such a few number of printer drivers, I have
  106. also included a program to create your own printer driver for use
  107. with ACCU Music Printer.  This program is called MUSCNFIG.EXE. 
  108. If you have a printer which has a printer driver already made for
  109. it, follow these steps:
  110.  
  111. 1.   At the DOS prompt, type the command:
  112.  
  113.                    COPY FILENAME.PRT MUSIC.PRT
  114.  
  115.      Replace the word FILENAME with the name of the printer
  116.      driver.  For example, if you wanted to use the printer
  117.      driver GEMINI10.PRT, the line would read:
  118.  
  119.                    COPY GEMINI10.PRT MUSIC.PRT
  120.  
  121.      This will create a copy of your printer driver under the
  122.      name MUSIC.PRT.
  123.  
  124. 2.   That's it!  Your printer driver is all set up.
  125.  
  126.      If a driver for your printer is not included with ACCU Music
  127. Printer, you must use the MUSCNFIG.EXE program.  The following
  128. description explains how to use it.
  129.  
  130. USING 'MUSCNFIG.EXE' TO CREATE PRINTER DRIVERS
  131.  
  132. NOTE:     If you have a laser printer not Hewlett Packard compat-
  133.           ible, special printer routines need to be written for
  134.           it.  I would be glad to do this for you.  Please send
  135.           me a letter telling me your printer name and hopefully
  136.           we can work something out.  Do not use MUSCNFIG.EXE for
  137.           laser printers!
  138.  
  139. NOTE:     Laser printer drivers cannot be loaded up with
  140.           MUSCNFIG.EXE.  Any attempt to do so will result in
  141.           unpredictable problems!
  142.  
  143.      Load up MUSCNFIG.EXE from DOS.  It will give you a menu that
  144. looks like the following:
  145.  
  146.      1. Define Printer Name
  147.      2. Set up printer strings
  148.      3. Save printer configuration
  149.      4. Load printer configuration
  150.      5. Clear printer configuration
  151.      6. Quit program
  152.  
  153.      You can select an option by pressing its number and then
  154. RETURN or by highlighting it with the arrow keys and pressing
  155. RETURN.
  156.  
  157.      Begin by giving your printer driver a name.  Select option 1
  158. and enter the name of your printer.  If you make a mistake,
  159. select option 1 again and retype the printer name.
  160.  
  161.      Next, select option 2 to create the printer strings.  GET
  162. OUT YOUR PRINTER MANUAL!!  You will first be asked several
  163. questions about your printer.  The first question asks whether
  164. your printer gives the top printhead pin a value of 128. 
  165. Typically the printer will give this pin a value of 128 or 1. 
  166. Select YES for 128 or NO for 1.  This will affect whether your
  167. music is printed inverted or normal.
  168.  
  169.      Next, you are asked three more questions concerning the
  170. graphics capabilities of your printer.  The three resolutions
  171. supported are:  480 dots/line (60 dots/inch), 960 dots/line (120
  172. dots/inch), and 1920 dots/line (240 dots/inch).  You will be
  173. asked for each resolution whether your printer supports it.  Just
  174. select YES or NO depending on what your printer manual says.
  175.  
  176.      The last question is asked only if you said that your
  177. printer supported 1920 dots/line.  You are then asked whether
  178. your printer requires two passes to print a full line at this
  179. resolution.  Typically your printer manual will say something
  180. like "Can't print adjacent dots" in this case.  If you are
  181. unsure, just press YES.
  182.  
  183.      You will now enter the decimal code numbers for each printer
  184. function.  You need to enter 3 digits for each code number.  That
  185. means for the number 27, enter 027.  For the number 0, enter 000. 
  186. After entering these 3 digits, press RETURN.  It will advance to
  187. the next code number entry.  When you are done entering code
  188. numbers for that printer function, press RETURN at an entry
  189. number prompt without typing anything.  This might seem a little
  190. confusing so the following is an example:
  191.  
  192.      Lets assume you want to enter the numbers 27, 87, 102, and 1
  193. for a function.  You would type:
  194.  
  195.       027<RETURN>087<RETURN>102<RETURN>001<RETURN><RETURN>
  196.  
  197.      Be sure to press RETURN where it says <RETURN>.  You need to
  198. enter code numbers for the following printer functions:
  199.  
  200.      o    Resetting the printer to its initial state when turned
  201.           on.
  202.      o    Setting linefeed to 1/6 inch spacing.  Make sure this
  203.           is for setting all linefeeds to 1/6 inch, not just a
  204.           one time 1/6 inch linefeed.
  205.      o    Setting linefeed to 8/72 inch spacing.  Make sure this
  206.           is for setting all linefeeds to 8/72 inch, not just a
  207.           one time 8/72 inch linefeed.
  208.      o    Turning on double wide print mode.
  209.      o    Turning off double wide print mode.
  210.      o    Turning on enhanced or NLQ printing.
  211.      o    Turning off enhanced or NLQ printing.
  212.      o    Setting Graphics mode to 480 dots per line (60 dots per
  213.           inch).  Make sure this is for 8 pin mode, not 9 pin.
  214.      o    Setting Graphics mode to 960 dots per line (120 dots
  215.           per inch).  Make sure this is for 8 pin mode, not 9
  216.           pin.
  217.      o    Setting Graphics mode to 1920 dots per line (240 dots
  218.           per inch).  Make sure this is for 8 pin mode, not 9
  219.           pin.
  220.      o    Setting linefeed to 0/n inch spacing.  'n' can be any
  221.           number your printer supports just as long as it
  222.           supports a 0/n inch linefeed mode (no movement).  Make
  223.           sure this is for setting all linefeeds to 0/n inch, not
  224.           just a one time 0/n inch linefeed.
  225.  
  226.      If you make a mistake while entering these codes or
  227. answering the questions, finish with the rest of the questions
  228. and code numbers for the other printer functions.  Then select
  229. the 2 option from the main menu again.  Answer the questions
  230. correctly.  This time, just press RETURN at the prompt for each
  231. printer function you entered correctly.  This will skip entering
  232. the data for that function, but will retain the data you entered
  233. previously.  When you come to a function which you entered
  234. incorrectly or that has no 'Old data', just type in the correct
  235. code numbers.  They will overwrite the old ones.
  236.  
  237.      After you have finished answering all of the questions,
  238. entering all of the code numbers for each printer function, and
  239. defining the name of the printer, select the 3 option (save
  240. printer configuration) from the main menu.  It will prompt you
  241. for a save filename.  I recommend a filename which will give you
  242. some idea of what kind of printer it is.  Make sure it has the
  243. extension .PRT, and be sure that it is not called MUSIC.PRT.  You
  244. are now done creating a printer driver.  You can always use the 4
  245. option (load printer configuration) to load up the printer driver
  246. and make changes if you need to.  [NOTE:  Don't forget the .PRT
  247. extension when load up the printer driver!]
  248.  
  249.      Once you have created a printer driver, there is one last
  250. step in order for it to work with ACCU Music Printer.  That is
  251. the same step as if you had already had a printer driver ready
  252. for your printer.  Just follow these directions:
  253.  
  254. 1.   At the DOS prompt, type the command:
  255.  
  256.                    COPY FILENAME.PRT MUSIC.PRT
  257.  
  258.      Replace the word FILENAME with the name of the printer
  259.      driver.  For example, if your printer driver was named
  260.      JOHNDOE.PRT, the line would read:
  261.  
  262.                    COPY JOHNDOE.PRT MUSIC.PRT
  263.  
  264.      This will create a copy of your printer driver under the
  265.      name MUSIC.PRT.
  266.  
  267. 2.   That's it!  Your printer driver is all set up.
  268.  
  269.      That explains how to get a printer driver set up for your
  270. printer.
  271.  
  272. RUNNING MUSIC.EXE
  273.  
  274.      Run MUSIC.EXE from the DOS prompt.  If you forgot to set up
  275. a printer driver, you will get an error message.  Please refer to
  276. the section "SETTING UP THE PROGRAM" which is listed above.  If
  277. the program loads successfully, you will be presented with the
  278. title of the program, the name of your current printer, and a
  279. menu.  The menu will look something like this:
  280.  
  281.      1. Enter Filename    
  282.      2. Set Clef          
  283.      3. Set Key           
  284.      4. Set Time Signature
  285.      5. Options
  286.      6. Set Print Quality 
  287.      7. Begin Printing    
  288.      8. Quit Program      
  289.  
  290. You will also get a status box up in the upper-right hand corner
  291. of the screen.  This will show basically all of the information
  292. that you have input so far.  The 'Status:' portion refers to what
  293. is currently happening.  It will displaying 'Printing' when
  294. printing, or 'Aborted' when the printing is aborted.
  295.  
  296.      Select the option 'Enter Filename' (#1) and enter the name
  297. of your music filename here.  See below for information about
  298. creating your own music file.
  299.  
  300.      Next, select the option 'Set Clef' (#2) and enter the name
  301. of the clef of your music.  You can choose from "T)reble, B)ass,
  302. TeN)or, A)lto, and S)oprano".
  303.  
  304.      The third option 'Set Key' will allow you to set the initial
  305. key signature of your music.  After selecting this, press F for
  306. F)lats or S for S)harps.  If you want no flats or sharps, select
  307. either one.  You then be asked how flats or sharps you want
  308. (depending on which one you selected).  Enter a number from 0 to
  309. 7.  Enter 0 if you want no flats or sharps.
  310.  
  311.      Continue by selecting the option 'Set Time Signature' (#4)
  312. and enter the time signature.  Just enter the time signature as a
  313. two digit number - with no separator between the numbers.  A time
  314. signature of 2/4 (2 on the top, 4 on the bottom) would be entered
  315. as 24.
  316.  
  317.      With selection #5, "Options", you can set the left and right
  318. margins for your printout.  It will display the current settings
  319. which default to zero inches for both margins.  The distance is
  320. measured from each edge of the paper, so you would not enter 7.5
  321. for your right margin, but 1 since it is one inch from the right
  322. edge of the paper (it is assumed that your paper is 8.5 inches
  323. wide).  You can enter a number from 0 to 2 inches for your
  324. margins.  You can use decimal points.
  325.  
  326.      Option #6, 'Set Print Quality' will allow you to determine
  327. what your printout will look like.  Depending on what your
  328. current printer and printer driver allows you to do, you will be
  329. given several quality specifications.  You may not be given all
  330. of them since your printer may not support them.  If your printer
  331. supports all resolutions, it will give you the options D)raft,
  332. M)edium, and H)igh.  Select the letter of the print quality you
  333. want.  Due to the high resolution of the notes, your music will
  334. not look its best unless it is printed at H)igh mode.  At the
  335. D)raft and M)edium modes the printout may look bad.  It is
  336. because it can't print everything when it prints at the lower
  337. resolutions.  If you are using a laser printer, the Print Quality
  338. option will not work and will always print at 300 dpi (make sure
  339. you have enough printer RAM).
  340.  
  341.      The option 'Begin Printing' (#7) will allow you to print out
  342. your music.  It will not work if you haven't input a filename or
  343. set a print quality (only for non-laser printers).  You will be
  344. asked for a title and author then.  You can either type something
  345. in or press RETURN at each prompt if you want nothing.  It will
  346. then begin printing.  It will load the file as it prints so be
  347. sure the disk file is available during this time.  Be sure the
  348. printer is turned ON before you press RETURN after the Author
  349. prompt!  Any status messages will appear in the box under catego-
  350. ry "Status".  You can press ESC to abort the printing (it will
  351. wait till the end of the current staff line to stop printing). 
  352. The program will return to DOS when it is done.
  353.  
  354.      The last option (#8) 'Quit Program' will exit the program
  355. and return you to DOS.
  356.  
  357. PRINTING SOME SAMPLE MUSIC
  358.  
  359.      Included with Version 2.0 of ACCU Music Printer is the file
  360. STARBANN.ACC.  This is the music for the Star Spangled Banner. 
  361. To print it out, make sure you have correctly set up your printer
  362. driver.  Then, load up MUSIC.EXE.  Select option #1 and enter the
  363. filename 'STARBANN.ACC' and press RETURN (without the apost-
  364. rophes).  Next select the print quality with option #6.  Last of
  365. all, select option #7.  Be sure the disk with the file is in the
  366. drive and the printer is turned on.  At the title prompt press
  367. RETURN and at the author prompt press RETURN too.  The program
  368. should print out the music to the Star Spangled Banner then.
  369.  
  370. CREATING YOUR OWN MUSIC
  371.  
  372.      You may be thinking by now, "This is great, but how do I
  373. print out my own music?"  Well, here comes that information.  The
  374. first step is to load up your word processor or any good text
  375. editor (something as simple as EDLIN will work too).  You will be
  376. entering information specifically for the printout by ACCU Music
  377. Printer.  That means that anything you type will appear in the
  378. sheet music.  The format for each command is as follows:
  379.  
  380. Note Letter/Accidental/Octave Number/Note Length/Dot/Tie/Dynamic
  381.  
  382. A description of each part follows:
  383.  
  384.      Note letter         This is the musical letter of the note. 
  385.                          Valid note letters are:  C, D, E, F, G,
  386.                          A, B, R.  The R is for rest.  Use it if
  387.                          you want a rest instead of a regular
  388.                          note.
  389.  
  390.      Accidental          This is the accidental of the note. 
  391.                          Some valid accidentals are:  N
  392.                          (natural), S (sharp), F (flat), *.  Only
  393.                          use an accidental if you want it to
  394.                          appear on the music.  For example, if
  395.                          all of the notes in a song are natural,
  396.                          do not put an N for all of their
  397.                          accidentals.  Use an *.  That means that
  398.                          ACCU Music Printer will just print the
  399.                          note with no accidental.  For rests, be
  400.                          sure to use an *.
  401.  
  402.      Octave Number       This is the octave number of the note. 
  403.                          It ranges from 1 to 8.  If the note is a
  404.                          rest, use an * instead of an octave
  405.                          number.  Each octave goes from lower C
  406.                          to the B above it.  Octave 8 only
  407.                          contains lower C.  The following diagram
  408.                          gives you an idea where on the staff
  409.                          each octave is:
  410.  
  411.                              G
  412. ---------------------------F  ---------------------------
  413.                              E
  414. ---------------------------D  ---------------------------
  415.        Treble                C  - Start of octave 5
  416. ---------------------------B  ---------------------------
  417.         Clef                 A         
  418. ---------------------------G  ---------------------------
  419.                              F
  420. ---------------------------E  ---------------------------
  421.                              D
  422.                     Middle C    - Start of octave 4
  423.                              B
  424. ---------------------------A  ---------------------------
  425.                              G
  426. ---------------------------F  ---------------------------
  427.         Bass                 E
  428. ---------------------------D  ---------------------------
  429.         Clef                 C    - Start of octave 3
  430. ---------------------------B  ---------------------------
  431.                              A
  432. ---------------------------G  ---------------------------
  433.                              F
  434.                            E
  435.  
  436.      Note Length         This is how long the note is.  Valid
  437.                          note lengths are W (whole note), H (half
  438.                          note), Q (quarter note), E (eighth
  439.                          note), and S (sixteenth note).  Rests
  440.                          must have a note length.
  441.  
  442.      Dot                 This is whether the note is dotted.  If
  443.                          it is, there is a period immediately
  444.                          following the note length.  If not,
  445.                          there is NO period following the note
  446.                          length.
  447.  
  448.      Tie                 This is whether the note it tied.  If it
  449.                          is, there is a T following the last
  450.                          character.  If it is not, there is
  451.                          nothing following the last character. 
  452.                          [NOTE:  Ties do not work in this version
  453.                          of ACCU Music Printer.  Include them in
  454.                          your music so that in future versions
  455.                          you won't have to modify your music.]
  456.  
  457.      Dynamic             This is the dynamic of the note.  It is
  458.                          optional.  Dynamics can be "fff", "ff",
  459.                          "f", "mf", "mp", "p", "pp", "ppp", etc. 
  460.                          After the last character of the note
  461.                          command, put a slash ('/') and then the
  462.                          dynamic (in lower case).  For a "mf"
  463.                          note, you would add "/mf" to the end of
  464.                          the note command.  See examples for a
  465.                          better illustration.  Do not add
  466.                          dynamics to rests!  Only changes in the
  467.                          dynamics will be printed on the music,
  468.                          so if you want to put dynamics, do it on
  469.                          EVERY note!
  470.  
  471. NOTE:  All of the note command should be in UPPERCASE except for
  472. the dynamic portion (eg. mf or f or p).  Eg. C*4E/mf
  473.  
  474. The following are some examples:
  475.  
  476.      C*4E           This is a C note, with no accidental, in the
  477.                     4th octave and is an eighth note.
  478.  
  479.      FS5Q.          This is a F note, with a sharp accidental, in
  480.                     the 5th octave, a quarter note, and is
  481.                     dotted.
  482.  
  483.      B*3ST          This is a B note, with no accidental, in the
  484.                     3rd octave, sixteenth note, and is tied.
  485.  
  486.      R**Q           This is a quarter rest.
  487.  
  488.      GN6H.T         This is a G note, with a natural accidental,
  489.                     in the 6th octave, half note, dotted, and is
  490.                     tied.
  491.  
  492.      BN4Q/mf        This is a B note, with a natural accidental,
  493.                     in the 4th octave, quarter note, "mf"
  494.                     dynamic.
  495.  
  496.      G*5H.T/fff     This is a G note, with no accidental, in the
  497.                     5th octave, half note, dotted, tied, and is
  498.                     "fff" dynamic.
  499.  
  500.      In addition to the usual whole measure rest "R**W", I have
  501. added a new type of rests common to musicians.  It is the multi-
  502. ple measure rest.  It shows up on the music as 1.5 inch line with
  503. the number of whole measure rests written above it.  The command
  504. is "Xn" where 'n' is the number of whole measure rests.  Do not
  505. use it for only 1 whole measure rest.  Anything 2 or greater is
  506. okay.  Be sure to put the "Xn" command between two measure bars
  507. (just like a whole rest usually is).  Some examples are:
  508.  
  509.      X2             Two measures of whole rests.   
  510.  
  511.      X12            Twelve measures of whole rests.
  512.  
  513.      X6             Six measures of whole rests.   
  514.  
  515.      There are a few other things that you must know in order to
  516. enter music for ACCU Music Printer.  The first is that you need
  517. to divide your music into measure bars.  If you don't you'll run
  518. into major problems.  To put a measure bar in your music, use
  519. 'M***' as the note.  Do not put a measure bar at the beginning or
  520. end of your music.  At the end of your music use 'Q***' as the
  521. note.  This tells ACCU Music Printer that this is the end of your
  522. music.  The following is a sample scale divided into measures:
  523.  
  524.                               C*4Q
  525.                               D*4Q
  526.                               E*4Q
  527.                               F*4Q
  528.                               M***
  529.                               G*4Q
  530.                               A*4Q
  531.                               B*4Q
  532.                               C*5Q
  533.                               M***
  534.                               D*5Q
  535.                               C*5Q
  536.                               B*4Q
  537.                               A*4Q
  538.                               M***
  539.                               G*4Q
  540.                               F*4Q
  541.                               E*4Q
  542.                               D*4Q
  543.                               M***
  544.                               C*4Q
  545.                               R**H
  546.                               R**Q
  547.                               Q***
  548.  
  549.      That explains everything necessary to make your own music. 
  550. If you do decide to use a word processor to create your music, be
  551. sure to convert the file to ASCII text when done using the word
  552. processor.
  553.  
  554. ADVANCED MUSIC COMMANDS
  555.  
  556.      As you may have noticed, entering the key signature, time
  557. signature, title, author, etc. each time you want to print a
  558. piece of music becomes tedious.  In addition, this allows you to
  559. have only one time signature and key signature per piece of
  560. music.  As a result, a series of special commands have been added
  561. to ACCU Music Printer to overcome these limitations.
  562.  
  563.      COMMENT
  564.  
  565.      One function that is quite useful is the comment.  This
  566. allows you to put comments in your music telling where you are in
  567. the music or to describe something in the music.  Comments are
  568. NOT printed and are totally disregarded by the program.  Comments
  569. must be on their own line (with no music commands on the same
  570. line).  On the first column of the comment there must be a semi-
  571. colon ;.  A few examples of comments might be:
  572.  
  573.      M***
  574.      ; This is the second ending of the music
  575.      E*4Q
  576.      F*4H.
  577.      M***
  578.      G*4H
  579.      G*4H
  580.      Q***
  581.      ; That's the end.
  582.  
  583.      TITLE, AUTHOR
  584.  
  585.      Two of the special commands which are closely related are
  586. TITLE and AUTHOR.  They allow you to set the Title and Author of
  587. the piece of music.  They must be at the very beginning of the
  588. song (before any music data).  The format for them is:
  589.  
  590.      TITLE=Your Title Here
  591.      AUTHOR=Me
  592.  
  593.      Just put the title or author immediately following the equal
  594. = sign without any quotes of apostrophes.  The equal sign is
  595. necessary.
  596.  
  597.      CLEF
  598.  
  599.      Another command that is quite useful is CLEF.  This allows
  600. you to set the clef of the music.  At this point in time it can
  601. only be used at the very beginning of the song (before any music
  602. data).  It is used to set the initial clef.  For now, you can
  603. only have one clef per song.  After the CLEF= (all special
  604. commands have an equal sign after them), you need to put a letter
  605. telling what clef.  This letter is the same as the one you would
  606. press if you were entering the Clef from the menu.  The valid
  607. letters are:  T - treble, B - bass, N - tenor, A - alto, S -
  608. soprano.  An example might be:
  609.  
  610.      CLEF=N
  611.      ; This sets the clef to TENOR
  612.  
  613.      TIME
  614.  
  615.      The TIME command allows you to set the time signature in
  616. your music.  You can use it anywhere within your song.  It is
  617. useful for initially setting the time signature of a song in
  618. addition to changing the time signature partway through the song. 
  619. The TIME command must IMMEDIATELY follow a measure bar (M***). 
  620. The format for the TIME command is TIME=tb.  The 't' would be the
  621. top number of the time signature and 'b' would be the bottom
  622. number of the time signature.  Don't forget the equal sign. 
  623. There is one limitation to the TIME command.  When you change
  624. both the TIME signature and the KEY (discussed later), it will
  625. not output correctly when you combine both of them.  You can
  626. change each of these individually, but not together.  You will
  627. see what I mean if you try this.  This should be fixed in a later
  628. version of the program.
  629.  
  630.      E*4Q
  631.      F*4Q
  632.      G*4H
  633.      M***
  634.      TIME=24
  635.      ; This would set the time signature to 2/4
  636.      G*4H
  637.      F*4Q
  638.      E*4Q
  639.      Q***
  640.  
  641.      KEY
  642.  
  643.      The KEY command allows you to change the key signature of
  644. your music.  It can be used both at the beginning of the song and
  645. elsewhere within the song.  It must IMMEDIATELY follow a measure
  646. bar (M***).  The format for the KEY command is KEY=nT (where 'T'
  647. is either F for Flats or S for Sharps and 'n' is the number of
  648. each).  As mentioned in the TIME command, there is one limitation
  649. to the KEY command.  If you combine both a KEY command and a TIME
  650. command at the same spot, it will not output correctly.  This
  651. will be fixed in a future version.
  652.  
  653.      E*4Q
  654.      F*4Q
  655.      G*4H
  656.      M***
  657.      KEY=3F
  658.      ; This sets the key to 3 flats
  659.      E*4Q
  660.      F*4Q
  661.      G*4H
  662.      M***
  663.      KEY=0F
  664.      ; This sets the key to no flats/sharps
  665.  
  666.      If you want to set the KEY to 0 flats/sharps at the begin-
  667. ning of your song, be sure to not to set the key signature at the
  668. main menu.
  669.  
  670.      E*4Q
  671.      F*4Q
  672.      G*4H
  673.      M***
  674.      TIME=44
  675.      KEY=2F
  676.      ; This is an example of what won't work!
  677.  
  678.      Any of the advanced commands can be used to replace the
  679. manual settings at the main menu.  Be sure to set the settings
  680. from the main menu OR use the advanced commands.  Do not forget
  681. to use either one.  Also, the advanced commands override any
  682. manual settings.
  683.  
  684. TRANSPOSER
  685.  
  686.      The transposer is a utility included as of Version 2.0.  It
  687. allows you to transpose music UP or DOWN a number of half steps. 
  688. This means you could have it transpose some music down an octave
  689. or maybe from one instrument to another.  Another feature of the
  690. transposer is that it allows you to specify the key signature of
  691. the output file.  This is useful for changing music from a
  692. difficult key to an easier one.
  693.  
  694.      Begin by executing TRANPOSE.EXE.  You will be shown the
  695. program title and then you will be asked some questions.  First
  696. enter the name of the file that you wish to transpose (this
  697. should be a file in the ACCU Music Printer format).  Next enter
  698. the name of the output file.  This will be the file that is
  699. created.
  700.  
  701.      Enter the tranpose amount in half steps.  Enter a positive
  702. number (without the plus sign) to transpose UP or a negative
  703. number (WITH the negative sign) to transpose DOWN.  You may enter
  704. 0 or any other number.  Remember that there are 12 half steps per
  705. octave.  If you enter a number too big or too small, it will
  706. automatically put the transposed note in the next closest octave. 
  707. An example of using half steps would be:  transposing CN4Q up 2
  708. half steps would make it DN4Q.
  709.  
  710.      Next, enter the key signature of the file you are
  711. transposing.  If your key signature has no flats or sharps,
  712. select either Flats or Sharps and then enter 0 for the number. 
  713. If you have the key indicated in the file (using the advanced
  714. command KEY=), just enter any key at this prompt.  It doesn't
  715. make a difference as long as there is a KEY= command at the
  716. beginning of your music file.
  717.  
  718.      It will next ask you if you would like the output file to
  719. have a key signature with flats or sharps.  Select either one,
  720. depending on your preference (if you want no flats or sharps,
  721. select either one and read below).  You will then be asked
  722. whether you want to specify the number of flats or sharps
  723. (depending on what you selected in the previous question) in the
  724. resulting output file.  Select Y)es or N)o.  If you want neither
  725. flats or sharps in the key signature, select Y)es.  If you select
  726. Y)es, you will be asked how many flats or sharps (depending on
  727. what you chose) you want in the new key signature.  If you want
  728. neither flats or sharps, enter a 0.
  729.  
  730.      The transposer will then scan your music file and create an
  731. output file.  If you have multiple key signature changes within
  732. the input file, they will all be combined into one key for the
  733. output file.  If you did not select the number of flats or sharps
  734. for the resulting file, the program will determine an optimal key
  735. and then rewrite the music according to the new key.
  736.  
  737. NOTES FROM THE AUTHOR
  738.  
  739.      It has been well over three months since the last version of
  740. ACCU Music Printer.  I am really sorry for the delay.  I have
  741. been quite amazed at the number of registrations that I actually
  742. received.  I greatly appreciate your support of my programming
  743. efforts.
  744.  
  745.      For those of you who registered, you deserve an explanation
  746. of the delays.  First of all, I worked full-time during the
  747. summer and this occupied much of my time.  In addition, when
  748. school started I had just as little time available.  There have
  749. been many major changes to the program which have required some
  750. extra programming work.  My family has been moving and I wanted
  751. to hold this release of the program until we got the new address. 
  752. Also, I was waiting for the new version of C, Turbo C++, which I
  753. ordered (thanks in part to the registrations).  Last of all, I
  754. have been applying to college.
  755.  
  756.      Reading comments about the program has proved a valuable
  757. asset in learning what to change.  Although I already had plans
  758. for things to modify (such as higher resolution notes), I made an
  759. attempt to add any suggestions that I saw as feasible at this
  760. point in time.  I will keep in mind all of your suggestions as I
  761. continue to upgrade this program.  After using this new version,
  762. please mail me the comment form with any ideas, changes, or bugs
  763. so I know where to go from here.
  764.  
  765. ABOUT THE AUTHOR
  766.  
  767.      I live in Poway, California which is a city only 30 miles
  768. away from downtown San Diego.  I am 18 and am attending Poway
  769. High School as a senior.  I have been programming for over six
  770. years.  I first started out on the Atari 800 with BASIC and have
  771. progressed to C on the IBM PC.  I have written several other
  772. shareware programs for the Atari, but no others for the IBM yet.
  773.  
  774. ABOUT THE PROGRAM
  775.  
  776.      ACCU Music Printer is written in C and compiled with Turbo
  777. C++.  It started out as a BASIC program on my Atari.  It easily
  778. outgrew that and so was rewritten in C on the IBM.  It is cur-
  779. rently over 4000 lines long.  Any comments or questions about the
  780. program and how it works are welcome.
  781.  
  782. FUTURE REVISIONS
  783.  
  784.      Assuming I receive some support or acknowledgement that this
  785. program is any good, I will continue making enhancements.  Future
  786. enhancements include the following:
  787.  
  788.      o    More already written music files ready to print with
  789.           ACCU Music Printer.
  790.  
  791.      o    Enhanced printer output.  This means that several
  792.           consecutive eighth notes and sixteenth notes will be
  793.           connected together instead of separate.  Also, the
  794.           addition of thirty-second notes would be nice.  The
  795.           addition of ties will be coming in the future.
  796.  
  797.      o    Fixes to advanced command limitations
  798.  
  799.      o    A Scorer which would take several ACCU Music Printer
  800.           files and print them out like a director's score or
  801.           something like you would find in a music book.
  802.  
  803.      o    A Conversion program to allow your ACCU Music Printer
  804.           files to be converted to Adlib/Soundblaster .ROL files
  805.           and played with the VISUAL COMPOSER program by Adlib.
  806.  
  807.      o    An Entry program to ease the entering of ACCU Music
  808.           Printer songs.  It will feature a graphical display of
  809.           the music in addition to a text-based entry system.
  810.  
  811. ACCU MUSIC PRINTER REGISTRATION
  812.  
  813.      ACCU Music Printer is being distributed as ShareWare.  If
  814. you find it useful or use it every so often, please register your
  815. program.  Three registration plans are available:
  816.  
  817.      o Plan 1       Fill out the registration form and mail it
  818.                     with $5.00.  You will receive the next
  819.                     version of ACCU Music Printer on disk with
  820.                     printed documentation.  You will ONLY receive
  821.                     the next version.
  822.  
  823.      o Plan 2       Fill out the registration form and mail it
  824.                     with $12.00.  You will receive the next three
  825.                     major versions of ACCU Music Printer on disk
  826.                     with printed documentation for only the major
  827.                     versions.
  828.  
  829.                     ....  one more plan  ....
  830.  
  831.      o Plan 3       Send anything over $20.00 and I will supply
  832.                     you with a version of ACCU Music Printer each
  833.                     time I make a major version.  Printed
  834.                     documentation will come with the major
  835.                     versions!  That means you will get a version
  836.                     until I stop making them.
  837.  
  838.      You may be wondering, "How come he doesn't give unlimited
  839. versions at $12.00?"  I have to worry about expenses.  Disks cost
  840. around a $1.00 (assuming equal 3.5 and 5.25 inch disk usage) a
  841. piece.  Mailing costs at least $.50 (probably more with the Post
  842. Office raising rates).  And then I'd like to make some kind of
  843. profit.
  844.  
  845.      I would really appreciate any comments, questions, ideas,
  846. etc.  Anything I can get from the users will certainly help me
  847. make ACCU Music Printer a better program.  If you have any
  848. problems, BE SURE TO WRITE OR CALL ME!!  Just send me a note or
  849. write me a letter.  Be sure to include your return address in
  850. case I need to write you back.  There is a comment form near the
  851. end of this documentation.
  852.  
  853. Send all correspondence to:
  854.  
  855.                     Kevin Fischer           
  856.                     16878 St. James Drive   
  857.                     Poway, CA 92064-1137    
  858.                     USA                     
  859.  
  860.      See registration form on the next page if you feel like
  861. registering your ACCU Music Printer.
  862.  
  863. DISCLAIMER
  864.  
  865.      I do not accept any responsibility for any damages caused by
  866. ACCU Music Printer.  You are using this program at your own risk. 
  867. There are no warranties or guarantees that come with this
  868. program.
  869.  
  870. SHAREWARE
  871.  
  872.      This program is distributed as SHAREWARE.  No fee may be
  873. charged for it except by me.  If you decide to continue using
  874. this program, please consider registering it.
  875.  
  876. REVISION HISTORY
  877.  
  878.      Version 2.0         Added many new features including: 
  879.                          higher resolution printing; print margin
  880.                          changes; transposing program; key, time,
  881.                          title, author setting from within music
  882.                          file; alto, tenor, and soprano clefs; 3
  883.                          print modes, draft, medium, and high;
  884.                          redesigned program interfaces; plus
  885.                          several other modifications
  886.  
  887.      Version 1.5         Fixed bug which cut off top portion of
  888.                          sharp key signature when printing treble
  889.                          clef music.  Special thanks again to
  890.                          Russell Taliaferro for pointing out this
  891.                          bug.
  892.  
  893.      Version 1.4         Fixed bug which wouldn't print out sharp
  894.                          key signature when selected from
  895.                          MUSIC.EXE.  Special thanks to Russell
  896.                          Taliaferro for pointing out this bug.
  897.  
  898.      Version 1.3         Removed output of music to graphics
  899.                          screen.  No need for graphics card. 
  900.                          Output is dumped directly from memory to
  901.                          printer.  Print abort option added.
  902.  
  903.      Version 1.2         Fixed bug in printing which skipped
  904.                          certain staff lines.  Bug corrected. 
  905.                          Added laser printer support.  Added
  906.                          dynamic support.  Added extended number
  907.                          of rests.
  908.  
  909.      Version 1.1         Fixed bug in music formatting routine
  910.                          which caused measures in music to be
  911.                          skipped.  Bug corrected and music
  912.                          formatting routine works correctly. 
  913.                          Added version # and date of version to
  914.                          MUSIC.EXE program.
  915.  
  916.      Version 1.0         Initial release of ACCU Music Printer.
  917.  
  918. CONTACTING THE AUTHOR
  919.  
  920.      If you need to contact me for any reason, I can be reached
  921. at the location listed below.  Please phone if it is extremely
  922. urgent only.  I can also be reached on the RelayNET Soundcards
  923. conference (often known as the Adlib conference).  Just send a
  924. PUBLIC message to KEVIN FISCHER.
  925.  
  926.      Please NOTE, my address has changed since the last version
  927. of ACCU Music Printer.
  928.  
  929.                       Kevin Fischer        
  930.                       16878 St. James Drive
  931.                       Poway, CA 92064-1137 
  932.                       USA                  
  933.  
  934.                   or call voice (619)-487-5461
  935.                              INDEX
  936.  
  937. ACCIDENTAL . . . . . . . . . . . . . . . . . . . . . . . . .8, 10
  938. ADDRESS. . . . . . . . . . . . . . . . . . . . 15, 17, 19, 21, 22
  939. ADVANCED . . . . . . . . . . . . . . . . . . . . . . . 11, 14, 16
  940. ALTO . . . . . . . . . . . . . . . . . . . . . . . . . .1, 12, 18
  941. AUTHOR . . . . . . . . . . . . . . . . . . . 1, 7, 11, 12, 15, 18
  942. BASS . . . . . . . . . . . . . . . . . . . . . . . . . . . .9, 12
  943. BIOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1, 2
  944. CLEF . . . . . . . . . . . . . . . . . . . . . . .1, 6, 9, 12, 18
  945. COLOR. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1, 2
  946. COMMAND-LINE . . . . . . . . . . . . . . . . . . . . . . . . 1, 2
  947. COMMENT. . . . . . . . . . . . . . . . . . . . 11, 12, 15, 17, 21
  948. CREATING . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7
  949. DIRECT SCREEN. . . . . . . . . . . . . . . . . . . . . . . . . .1
  950. DOT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8, 9
  951. DRIVER . . . . . . . . . . . . . . . . . . . . . . . . .2, 3, 5-7
  952. DYNAMIC. . . . . . . . . . . . . . . . . . . . . . . . . 8-10, 18
  953. EDITOR . . . . . . . . . . . . . . . . . . . . . . . . . . . 1, 8
  954. EQUIPMENT. . . . . . . . . . . . . . . . . . . . . . . . . . . .1
  955. FUTURE . . . . . . . . . . . . . . . . . . . . . . . . .9, 13, 16
  956. KEY. . . . . . . . . . . . . . . . . . . . . .1, 6, 11, 13-15, 18
  957. MARGIN . . . . . . . . . . . . . . . . . . . . . . . . . 1, 7, 18
  958. MULTIPLE MEASURE REST. . . . . . . . . . . . . . . . . . . . . 10
  959. MUSCNFIG.EXE . . . . . . . . . . . . . . . . . . . . . . . . .1-3
  960. MUSIC.EXE. . . . . . . . . . . . . . . . . . . . . . .1, 6, 7, 18
  961. NEW. . . . . . . . . . . . . . . . . . . . . . . . .1, 10, 15, 18
  962. NOTE . . . . . . . . . . . . . . . . . . . . .3, 8-11, 14, 17, 19
  963. NOTE LENGTH. . . . . . . . . . . . . . . . . . . . . . . . . 8, 9
  964. NOTE LETTER. . . . . . . . . . . . . . . . . . . . . . . . . . .8
  965. OCTAVE NUMBER. . . . . . . . . . . . . . . . . . . . . . . . . .8
  966. OPTIONS. . . . . . . . . . . . . . . . . . . . . . . . 1, 2, 6, 7
  967. PRINTER. . . . . . . . . . . . . . . . . . 1-9, 11, 14-19, 21, 22
  968. PRINTING . . . . . . . . . . . . . . . . . . . . . 1, 4, 6, 7, 18
  969. PROGRAM. . . . . . . . . . . . . . . . . 1-3, 6, 7, 12-18, 21, 22
  970. REGISTRATION . . . . . . . . . . . . . . . . . . . . . 16, 17, 22
  971. REVISION . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  972. SETTING UP . . . . . . . . . . . . . . . . . . . . . . . . . 2, 6
  973. SHAREWARE. . . . . . . . . . . . . . . . . . . . . . . . . .16-18
  974. SOPRANO. . . . . . . . . . . . . . . . . . . . . . . . .1, 12, 18
  975. TENOR. . . . . . . . . . . . . . . . . . . . . . . . . .1, 12, 18
  976. TIE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8, 9
  977. TIME . . . . . . . . . . . . . . . . . . 1, 2, 4-7, 11-15, 17, 18
  978. TITLE. . . . . . . . . . . . . . . . . . .1, 6, 7, 11, 12, 14, 18
  979. TRANPOSE.EXE . . . . . . . . . . . . . . . . . . . . . . . .1, 14
  980. TRANSPOSE. . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  981. TREBLE . . . . . . . . . . . . . . . . . . . . . . . . .9, 12, 18
  982.  
  983.                        VERSION 2.0 COMMENT FORM
  984.  
  985.  
  986.      Name:
  987.  
  988.      ________________________________________________________
  989.  
  990.      Street Address:
  991.  
  992.      ________________________________________________________
  993.  
  994.      City, State and ZipCode:
  995.  
  996.      ________________________________________________________
  997.  
  998.      Ratings:  (1 to 10, 10 being the best)
  999.  
  1000. Documentation Quality     1   2   3   4   5   6   7   8   9   10
  1001.  
  1002. Program Quality           1   2   3   4   5   6   7   8   9   10
  1003.  
  1004. Program Value             1   2   3   4   5   6   7   8   9   10
  1005.  
  1006.      Comments and Questions:
  1007.  
  1008.      ________________________________________________________
  1009.  
  1010.      ________________________________________________________
  1011.  
  1012.      ________________________________________________________
  1013.  
  1014.      ________________________________________________________
  1015.  
  1016.      ________________________________________________________
  1017.  
  1018.      ________________________________________________________
  1019.  
  1020.      ________________________________________________________
  1021.  
  1022.      ________________________________________________________
  1023.  
  1024.      ________________________________________________________
  1025.  
  1026.      Use this form for sending comments, questions, etc. to me
  1027. concerning ACCU Music Printer.  Please do this even if you decide not
  1028. to register your program.  Your suggestions may make this a program
  1029. worth registering.
  1030.  
  1031.      Mail to:
  1032.  
  1033.                        Kevin Fischer           
  1034.                        16878 St. James Drive   
  1035.                        Poway, CA 92064-1137    
  1036.                        USA                     
  1037.                      VERSION 2.0 REGISTRATION FORM
  1038.  
  1039.  
  1040.      Name:
  1041.  
  1042.      ________________________________________________________
  1043.  
  1044.      Street Address:
  1045.  
  1046.      ________________________________________________________
  1047.  
  1048.      City, State and ZipCode:
  1049.  
  1050.      ________________________________________________________
  1051.  
  1052.      Home phone number:
  1053.  
  1054.      ________________________________________________________
  1055.  
  1056.      Type of computer system (type of computer, monitor, video card,
  1057.      disk drive, hard drive, printer, modem, etc.)
  1058.  
  1059.      ________________________________________________________
  1060.  
  1061.      ________________________________________________________
  1062.  
  1063.      ________________________________________________________
  1064.  
  1065.      Where did you get ACCU Music Printer?
  1066.  
  1067.      ________________________________________________________
  1068.  
  1069.      Comments about the program:
  1070.  
  1071.      ________________________________________________________
  1072.  
  1073.      ________________________________________________________
  1074.  
  1075.      ________________________________________________________
  1076.  
  1077.      ________________________________________________________
  1078.  
  1079.      Amount of money enclosed, registration plan number:
  1080.  
  1081.      ________________________________________________________
  1082.  
  1083.  Type of disks you use (3.5 or 5.25 inch, 360k, 720k, 1.2mb, 1.44mb):
  1084.  
  1085.      ________________________________________________________
  1086.  
  1087.      Thank you very much for registering your ACCU Music Printer
  1088. program.  You will be receiving the latest version of the program as
  1089. soon as it becomes available.
  1090.      Mail this form with your money to:
  1091.                       Kevin Fischer             
  1092.                       16878 St. James Drive     
  1093.                       Poway, CA 92064-1137   USA
  1094.